Skip to main content

Sites

Create and manage sites to host your applications and services within an organization.

Overview​

Sites are the deployment environments within an organization. Each site has its own database schema, domain, apps, secrets, and frontend workers. Sites can be used to separate different environments (production, staging, development) or different projects.

Concepts​

Site​

A site is a self-contained environment that includes its own database schema, applications, secrets, and configurations. Each site operates independently within an organization.

Environment​

Sites can be classified by environment type: Production, Staging, or Development. This helps organize and manage different deployment stages.

Schema Name​

A unique PostgreSQL schema identifier automatically generated for the site. This is used internally for database tenant isolation.

Create a Site​

Create a new site to start building applications and deploying services.

  1. Go to your Organization page in the Dashboard.
  2. Click the Sites tab.
  3. Click Create New Site.
  4. Fill in the site details:
    • Site Name: A descriptive name for your site (required)
    • Description: Optional description of the site's purpose
    • Environment: Select Production, Staging, or Development
    • Set as primary site: Check to make this the default site
    • Active: Check to enable the site immediately
  5. Click Create Site.
tip

Your site will be provisioned with:

  • Apps section for building custom applications
  • Frontend Platform for hosting and domain management
  • Frontend Workers for serverless deployment
  • Usage tracking and billing management

View Site Details​

  1. Go to your Organization page in the Dashboard.
  2. Click the Sites tab.
  3. Click Manage on the site card.
  4. The site dashboard displays:
    • Site Name: The display name
    • Status: Current status (Active, Inactive)
    • Domain: The site's domain URL
    • Description: Site description

Site Dashboard Navigation​

The site dashboard provides navigation tabs for different features:

TabDescription
OverviewSite information and quick actions
AppsManage applications within the site
Frontend WorkersDeploy serverless edge functions
SecretsManage site-level secrets
SettingsConfigure site settings and danger zone

Edit a Site​

  1. Navigate to the site in the Dashboard.
  2. Click Edit button in the site header.
  3. Update the site details:
    • Site Name: Change the display name
    • Description: Update the description
  4. Click Save.
note

The site slug and schema name cannot be changed after creation.

Site Overview​

The Overview tab shows:

Site Information​

  • Created: Date the site was created
  • Slug: The unique URL identifier

Apps Section​

  • View the most recent apps (up to 3)
  • Click View All to see all apps

Quick Actions​

Access common features quickly:

  • Manage Apps: Create and configure applications
  • Frontend Platform: Configure domain and hosting
  • Frontend Workers: Deploy serverless functions
  • Site Members: Manage user access

Site Status​

Sites can have different statuses:

StatusColorDescription
ActiveGreenSite is fully operational
ProvisioningYellowSite is being set up
SuspendedRedSite access is temporarily disabled
InactiveGraySite is disabled

Delete a Site​

warning

Deleting a site permanently removes all associated data including apps, functions, storage, and database tables. This action cannot be undone.

  1. Navigate to the site in the Dashboard.
  2. Click the Settings tab.
  3. Find the Danger Zone section.
  4. Click Delete Site.
  5. Type the site name to confirm.
  6. Click Delete Site Permanently.

Configuration​

Site Fields​

FieldDescriptionRequired
NameDisplay name for the siteYes
DescriptionOptional descriptionNo
EnvironmentProduction, Staging, or DevelopmentYes
Is PrimaryWhether this is the default siteNo
Is ActiveEnable or disable the siteNo

Environment Types​

EnvironmentUse Case
ProductionLive production workloads
StagingPre-production testing
DevelopmentDevelopment and experimentation

Limits​

ResourceLimit
Sites per organizationVaries by plan
Apps per siteVaries by plan
Secrets per site100
Frontend workers per site50
info

Need higher limits? Contact support to discuss your requirements.

Troubleshooting​

Site stuck in provisioning​

Problem: Site status shows "Provisioning" for an extended period.

Solution:

  1. Wait a few minutes as provisioning can take time.
  2. Refresh the page to check for status updates.
  3. Contact support if provisioning takes more than 15 minutes.

Cannot access site features​

Problem: Site tabs or features are not loading.

Solution:

  1. Check that the site is Active (not Suspended or Inactive).
  2. Verify you have the correct permissions for the site.
  3. Try refreshing the page or clearing browser cache.

Domain not working​

Problem: The site domain is not accessible.

Solution:

  1. Verify the site status is "Active".
  2. Check DNS configuration for custom domains.
  3. Wait for DNS propagation if recently configured (up to 48 hours).

Last Updated: January 2025